! ^ 

OHANDL - Overlay HandieV- rff,v...su Vv.-.a 04 Monday 21-Dec--87 11:40 
Table of contents: 

2~ 5 THE RUN- -T I HE OVERLAY MANDLER 
3- 4 *OVTAB OVERLAY TABLE 
4" 2 OVERLAY HANDLER CODE 



€ 
C 



uHAnDL - uvsT 


1 


2 000000 


3 


4 


5 


6 


7 


S 


9 


10 


11 


12 


13 


14 


15 


16 


17 


IB 


19 


20 



nAUHU vvo. wi- noncfay c'i-Dec-B/ 1 i : 40 Fape l 

. MCALL . HODULE 

. MODULE OHANDL, RELEASE=V05, VERSI0N=01> COMMENT==<Over lay Handler>> IDENT=NO, LIB=YES 

COPYRieHT (c) 1984 BY 
DIGITAL EaUIPMENT CORPORATION. MAYNARD, MASS. 
AIL RIGHTS RESERVED. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 



DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
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. SBTTL THE RUN~TIME OVERLAY HANDLER 
. fcNAUL (JUL 



THE FOLLOWING CODE IB INCLUDED IN THE USER'S PROGRAM BY THE 
LINKER WHENEVER LOW MEMORY OVERLAYS ARE REQUESTED BY THE USER. 
THE RUN -TIME LOW MEMORY OVERLAY HANDLER IS CALLED BY A DUMMY 
SUBROUTINE OF THE FOLLOWING FORM: 



JSR R5, *OVRH 

. WORD <OVERLAY # t.^6> 

. WORD <ENTRY ADDRFSS> 



CALL TO COMMON CODE FOR LOW MEMORY OVERLAYS 

# OF DESIRED SEGMENT 

ACTUAL CORE ADDRESS (VIRTUAL ADDRESS) 



ONE DUMMY ROUTINE OF THE ABOVE FORM IS STORED IN THE RESIDENT PORTION 

OF THE USER'S PROGRAM FOR EACH ENTRY POINT TO A LOW MEMORY OVERLAY SEGMENT 

ALL REFERENCES TO THE ENTRY POINT ARE MODIFIED BY THE LINKER TO BE 

REFERENCES TO THE APPROPRIATE DUMMY ROUTINE. EACH OVERLAY SEGMENT 

IS CALLED INTO CORE AS A UNIT AND MUST BE CONTIGUOUS IN CORE. AN 

OVERLAY SEGMENT MAY HAVE ANY NUMBER OF ENTRY POINTS, TO THE LIMITS 

OF CORE MEMORY. ONLY ONE SEGMENT AT A TIME MAY OCCUPY AN OVERLAY REGION. 

THERE IS ONE WORD PREFIXED TO EVERY OVERLAY REGION THAT IDENTIFIES THE 
SEGMENT CURRENTLY RESIDENI IN THAT OVERLAY REGION. THIS WORD IS AN INDEX 
INTO THE OVERLAY TABLE AND POINTS AT THE OVERLAY SEGMENT INFORMATION. 

UNDEFINED GLOBALS IN THE OVERLAY HANDLER MUST BE NAMED "*0VDF1» TO 
"*OVDFn" SUCH THAT A RANGE CHECK MAY BE DONE BY LINK TO DETERMINE IF 
THE UNDEFINED GLOBAL NAME IS FROM THE OVERLAY HANDLER. A CHECK IS 
DONE ON THE . RAD 50 CHARACTERS "*0V", AND THEN A RANGE CHECK IS DONE ON 
THE . RAD50 CHARATERS "DPI" TO "DFn". THESE GLOBAL SYMBOLS DO NOT APPEAR 
ON L.TNK MAPS, SINCE THEIR VALUE IS NOT KNOWN UNTIL AFTER THE MAP HAS BEEN 
PRINTED. CURRENTLY *OVDFi TO *0VDF5 ARE IN USE. 

GLOBAL SYMBOLS 0$READ AND 0*D0NE ARE USEFUL WHEN DEBUGGING OVERLAID 
PROGRAMS. 

0*READ: : WILL APPEAR IN THE LINK MAP AND LOCATES THE . READW 
STATEMENT IN THE OVbRl-AY HANDLER. 

0*DONE: : WILL APPEAR IN THE LINK MAP AND LOCATES THE FIRST 
INSTRUCTION AFTER THE . READW IN THE OVERLAY HANDLER. 
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MCALL . F^EADW, . . VI. . 

. . VI. . .: VI FORMAT 

bB J TL «UVTAB OVERLAY TABt E 

PSECT *07ABL, D, GBL, OVR 

+ 
OVERLAY TABLE STRUCTURE: 



I 
f 



LOG 64 ~> 



*DVTAl.il : 

. WORD <CORf? ADDR>> <RELATIVE BLK>, <WDRD COUNT> 

DUMMY SUBROUTINES F-"OR ALL OVERLAY SEGMENTS 



/D OVERLAYS 



$OVTAB: 
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*OVTAB OVERLAY TABLE 
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000010 
000010 

000012 
000016 
000020 
000022 



000024 
000036 
000040 
000042 
000044 
000046 
000050 

000052 
000054 

000056 
000064 
000070 
000072 
000076 
000100 

000102 
000104 



060502 
010046 
010146 
1 0246 



000422 

062701 
012102 
022512 
001406 



e t e c t e d 



103405 
012602 
012601 
012600 
011505 
000205 

104376 
000 

012767 
016701 
005021 
020167 
103774 
000743 

0000000 

oocoooe 



000001 




1 77772 ' 



373 

011501 
000012 

000006 



1 77724 



. SBTTL OVERLAY HANDLER CODr- 

. I'faLt; f ^$UHAND, GDL 

. f»SECT ZOHAND, GBL. OVR 

. ENABL LSB 

; *OVRH IS THE ENTRY POINT TO THE OVERLAY HANDLER 



*OVRH: : 



1*: 



. RAD50 /OVR/ 

MOV RO. -(BP) 

MOV R 1 , ~ < SP ) 

MOV R2, -<SP) 



BR 5* 

MOV ®R5, Rl 

ADD #*0VTAB-6, Rl 

MOV (Rl)+, R2 

CMP <R5)+, @R2 

BEQ 3* 



;THIS KEEPS HANDLER THE SAME SIZE AS V03 
: /O OVERLAY ENTRY POINT 
J SAVE REGISTERS 



FIRST CALL ONLY * * «■ 

PICK UP OVERLAY NUMBER 

CALC TABLE ADDR 

GET FIRST ARG. OF OVERLAY SEG. ENTRY 

IS OVERLAY ALREADY RESIDENT? 

YES, BRANCH TO IT 



THE . READW ARGUMENTS ARE AS FOLLOWS: 

CHANNEL NUMBER, CORE ADDRESS, LENGTH TO READ, RELATIVE BLOCK ON DISK 

THESE ARE USED IN REVERSE ORDER FROM THAT SPECIFIED IN THE CALL. 



(Rl)+ iREAD FROM OVERLAY FILE 
; RESTORE USERS REGISTERS 



0*READ: 


: . READW 


17, R2, @R1, 


0*DONE: 


: BCS 


4* 


3$: 


MOV 


(SP)+, R2 




MOV 


(SP)+, Rl 




MOV 


<SP)+, RO 




MOV 


@R5, R5 




RTS 


R5 


4*: 


EMT 


376 




. BYTE 


0, 373 


5*: 


MOV 


#11501, 1* 




MOV 


*0DF1, Rl 


6*: 


CLR 


(Rl) + 




CMP 


R 1 , *0DF2 




BLO 


6* 




BR 


1* 


*0DF1; ; 


. WORD 


*0VDF1 


*0DF2: : 


, WORD 


*0VDF2 


. DSABL 


LSB 




. END 







.i GET ENTRY ADDRESS 

J ENTER OVERLAY ROUTINE AND RESTORE USER'S R5 

i SYSTEM ERROR 10 (OVERLAY I/O) 



RESTORE SWITCH INSTR (MOV fiRS, Rl ) 

START ADDR FOR CLEAR OPERATION 

CLEAR ALL OVERLAY REGIONS 

DONE? 

LO --> NO, REPEAT 

AND RETURN TO CALL IN PROGRESS 

jHIGH ADDR OF ROOT SEGMENT + 2 (NXT AVAIL) 
-iHIGH ADDRESS OF /O OVERLAYS +2 (NXT AVAIL) 



*•«••»■ Assembler statistics 
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Work f ,i 1 e resd s 
Wot- k f i 3 e urr i t e s 
fcjize ot^ work f-ile 
Size of core pool 
Operating system 






1 7V20 
RT-n 



words 
Words 



41 Pages) 
70 Pages) 



Elapsed time: 00: 00; O'l. 17 

DK: OHANDL, LP: OHANDL=DK: OHANDL. MAC/C/N: SYH 
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-JiODFl 


4-42 


*0DF2 


4-44 


*OvDF 1 


4-4a 


*0VDF2 


4-49 


*OVRH 


4-:l2# 


*OVTAB 


3-t7# 


. . . VI 


3-2# 


. . . V2 


1-2 




1-2 




l-2# 


. . . V27 


1-2 


. . . V2B 


1-2 


. . . V3 


1-2 




l-2# 


. . . V5 


1~2# 


. OH AND 


1~2# 


0$DONE 


4-3 1# 


O^READ 


4-30# 



4- 
4- 



4041 
49# 



-JV 
■30 
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4- 
1 -P- 

1-;? 

l-2# 

1-2 
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1 -2# 
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1 -2 
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1-2 

1 -2 
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1-2 



1-2 
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J. 1^ 
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1 --2 



1-2 
1 -2^ 
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1 -2# 
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l-2# 
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l-2# 
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. CHO 


3--2# 




. CMl 


3-2# 




. end. 


J-ci# 




. CM3 


3~2# 




. CM4 


3-2# 




. CMS 


3-2# 




. CM6 


3-2# 




. CM7 


3-2# 




VI. . 


3~1# 


. AUDIT 


l-2# 


MO0UL 


1-1# 


MLCSI 


1~2# 


READW 


3-l# 


! 


7M0DU 


l-2# 



4-30 



4-30 



4-30 



4--30 

4-30 
3-2 

1 -2 

4-30 



